ToolItem: Annotate menu proxy item as nullable
authorDaniel Boles <dboles@src.gnome.org>
Sun, 3 Sep 2017 09:39:58 +0000 (10:39 +0100)
committerDaniel Boles <dboles@src.gnome.org>
Sun, 3 Sep 2017 09:59:33 +0000 (10:59 +0100)
It can be NULL. ::create-menu-proxy gave an example of when a NULL proxy
menu item could be useful, but the accessors did not annotate it as such.

gtk/gtktoolitem.c

index a705b9767516ff81d16adb47caa128ba5200531f..974ad585987c75384fc209fca887c2abc5b2eaf4 100644 (file)
@@ -849,7 +849,7 @@ gtk_tool_item_retrieve_proxy_menu_item (GtkToolItem *tool_item)
  * @menu_item_ids must match ensures that a #GtkToolItem
  * will not inadvertently change a menu item that they did not create.
  *
- * Returns: (transfer none): The #GtkMenuItem passed to
+ * Returns: (transfer none) (nullable): The #GtkMenuItem passed to
  *     gtk_tool_item_set_proxy_menu_item(), if the @menu_item_ids
  *     match.
  *
@@ -899,7 +899,7 @@ gtk_tool_item_rebuild_menu (GtkToolItem *tool_item)
 
 /**
  * gtk_tool_item_set_proxy_menu_item:
- * @tool_item: a #GtkToolItem
+ * @tool_item: (nullable): a #GtkToolItem
  * @menu_item_id: a string used to identify @menu_item
  * @menu_item: a #GtkMenuItem to be used in the overflow menu
  *